package com.ruoyi.inventory.service;

import java.math.BigDecimal;
import java.util.List;
import com.ruoyi.inventory.domain.TWarehouseStock;

/**
 * 库存Service接口
 * 
 * @author ruoyi
 * @date 2025-09-24
 */
public interface ITWarehouseStockService 
{
    /**
     * 查询库存
     * 
     * @param id 库存主键
     * @return 库存
     */
    public TWarehouseStock selectTWarehouseStockById(Long id);


    /**
     * 查询库存列表
     * 
     * @param tWarehouseStock 库存
     * @return 库存集合
     */
    public List<TWarehouseStock> selectTWarehouseStockList(TWarehouseStock tWarehouseStock);

    /**
     * 新增库存
     * 
     * @param tWarehouseStock 库存
     * @return 结果
     */
    public int insertTWarehouseStock(TWarehouseStock tWarehouseStock);

    /**
     * 使用悲观锁更新库存
     * @param warehouseCode 仓库编码
     * @param partNo 备件编码
     * @param quantity 数量
     * @param txType 交易类型
     * @return 结果
     */
    public int updateStockWithPessimisticLock(String warehouseCode, String partNo, BigDecimal quantity, String txType);

    /**
     * 修改库存
     * 
     * @param tWarehouseStock 库存
     * @return 结果
     */
    public int updateTWarehouseStock(TWarehouseStock tWarehouseStock);

    /**
     * 批量删除库存
     * 
     * @param ids 需要删除的库存主键集合
     * @return 结果
     */
    public int deleteTWarehouseStockByIds(Long[] ids);

    /**
     * 删除库存信息
     * 
     * @param id 库存主键
     * @return 结果
     */
    public int deleteTWarehouseStockById(Long id);

    /**
     * 根据盘点结果调整库存
     * 
     * @param warehouseCode 仓库编码
     * @param partNo 备件编号
     * @param adjustmentQuantity 调整数量（正数为盘盈，负数为盘亏）
     * @param remark 备注
     * @return 结果
     */
    public int adjustStockByInventory(String warehouseCode, String partNo, BigDecimal adjustmentQuantity, String remark);
}
